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Foreword 



rd , 



This Technical Specification has been produced by the 3 Generation Partnership Project (3 GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 

The present document is part of a TS-family covering the 3^^ Generation Partnership Project Technical Specification 
Group Services and System Aspects, Telecommunication management; as identified below: 

32.531: Software management; Concepts and Integration Reference Point (IRP) Requirements 

32.532: Software management Integration Reference Point (IRP); Information Service (IS) 

32.533: Software management Integration Reference Point (IRP); Common Object Request Broker 

Architecture (CORE A) Solution Set (SS) 
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1 Scope 

The present document contains the Software Management Interface IRP Information Services descriptions. 

2 References 

The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] 3GPP TR 21.905: "Vocabulary for 3GPP Specifications". 

[2] 3GPP TS 32.101: "Telecommunication management; Principles and high level requirements". 

[3] 3GPP TS 32.102: "Telecommunication management; Architecture". 

[4] 3GPP TS 21.905: "Vocabulary for 3GPP Specifications". 

[5] 3GPP TR 32.816: "Telecommunication management; Study on Management of Evolved Universal 

Terrestrial Radio Access Network (E-UTRAN) and Evolved Packet Core (EPC)". 

[6] 3GPP TS 32.531: "Telecommunication management; Software management; Concepts and 

Integration Reference Point (IRP) Requirements". 

[7] 3GPP TS 32.622: "Telecommunication management; Generic network resources Integration 

Reference Point (IRP); Network Resource Model (NRM)". 

[8] 3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP) 

management: Information Services". 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in TS 32.101 [2], TS 32.102 [3] and 

TR 21.905 [4] and the following apply. A term defined in the present document takes precedence over the definition of 

the same term, if any, in TS 32.531 [6], TS 32.101 [1], TS 32.102 [2] and TS 21.905 [4], in that order. 

3.2 Abbreviations 

For the purposes of the present document, the abbreviations given in TR 21.905 [4], TS 32.531 [6] and the following 
apply. An abbreviation defined in the present document takes precedence over the definition of the same abbreviation, if 
any, in TR 21.905 [4] and TS 32.531 [6]. 
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4 

4.1 



Information Object Classes 

Imported information entities and local labels 



Label reference 


Local label 


3GPP TS 32.622 [7], information object class, Top 


top 


3GPP TS 32.312 [8], information object class, managedGenericIRP managedGenericIRP 



4.2 Class diagram 

4.2.1 Attributes and relationships 

The diagram reflects the definitions in the text of the following clauses. In case of conflict text takes 
precedence. 



«lnformationObjectClass» 
SwManagement IRP 



+theSWManagementlRP 
relation-swManagementlRP-swI^MiagementCapabilitie)^ 

+theSWManagementCapabilities^^.^ n 



1 +theSWManagementlRP 

relation-swManaQementlRP-swProcess 

+th e SWF ro cess 




<lnformationObjectClass» 
SwMProcess 



relation-swManagementCapabilities-swManagementProfile 



+theSwManagementProfile 



OTrT 



relation-swManagementProfile-swProcess 



+theSWManageinentProfile 



«lnformationObjectClass> 
SwMProfile 
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4.2.2 Inheritance 

The diagram reflects the definitions in the text of the following clauses. In case of conflict text takes 
precedence. 



«lnformationObjectClass>:[ 
ManagedGenericIRP 

(from TS 32.312) 



A 



«lnformationObjectClass>^ 
SwManagement IRP 



«lnformationObjectClass>:^ 
Top 

(from TS 32.622) 



A 



«lnformationObjectClass» 
GenManCapabilities 



id 

nElnformation 

offeredFinalAdministrativeStatelnformatic^n 

stepsAndOfferedStopPointList 



A 



«lnformationObjectClass» 
SwMCapabilities 



swVersionToBelnstalledOfferList 



«lnformationObjectClass» 
GenManProfile 



id 

selectedFinalAdministrativeStat^ 

nElnformation 

stepsAndSelectedStopPointList 

versionNumber 



A 



«lnformationObjectClass>^ 
GenManProcess 



id 

nEldentification 
profileld 
steplnfoList 



A 



«lnformationObjectClass>^ 
SwIVIProfile 



swVersionToBelnstalled 



«lnformationObjectGlass>::[ 
SwM Process 
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4.3 Information object class definitions 
4.3.1 GenManCapability 



4.3.1.1 



Definition 



This object class is a support object class. Sub-classes of this IOC represent the IRPAgent"s 
capability in support of automated management. 

It is created by the IRP Agent and cannot be modified by the IRPManager. 

An instance of a sub-class of genManCapability object is valid for a certain NE type or a set of NE 

types. 

Multiple genManCapability objects may be instantiated in the IRPAgent. 

The object identifies 

a) the sequence of the self-configuration steps 
and for each step 

a.l) the possibility, whether before the step a stop point can be selected, such that the self- 
configuration step is suspended and waits for a request by the IRPManager to resume. 

b) the final administrativestate (ITU-T X.731) of the NE after successful self-configuration. 



4.3.1.2 



Attributes 



Attribute name 


Support Qualifier 


Read Qualifier 


Write Qualifier 


id 


M 


M 


- 


nEInformation 


M 


M 


- 


stepsAndOf f eredStopPointList 


M 


M 


- 


of f eredFinalAdminist rat iveS tat e Information 


M 


M 


- 



4.3.1.3 

None. 



Notifications 
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4.3.2 GenManProfile 



4.3.2.1 



Definition 



This object class is a support object class. Sub-classes of this IOC represent the IRPManager"s decision 
related to automated management. 

An instance of a sub-class of GenManProfile is valid for a certain NE type or a set of NE types. 
For an NE starting its self-configuration process (see genManProcess) there shall be no ambiguity 
which instance of a sub-class of GenManProfile is valid for a certain NE type or a set of NE types. 
Multiple instances of sub-classes of GenManProfile objects may be instantiated in the IRPAgent. 

By using an instance of a sub-class of this object the IRPManager decides which of the possible 
stop points offered in the related instance of a sub-class of genManCapability are used to suspend 
the automated management process of the specified NE type (or set of NE types) and which of the 

of f eredFinalAdministrativeStateInf ormation is selected. 



4.3.2.2 



Attributes 



Attribute name 


Support Qualifier 


Read Qualifier 


Write Qualifier 


id 


M 


M 


- 


ve r s i onNumb e r 


M 


M 


- 


nEInf ormation 


M 


M 


- 


stepsAndSelectedStopPointList 


M 


M 


- 


selectedFinalAdministrativeState 


M 


M 


- 



4.3.2.3 



Notifications 



None. 
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4.3.3 GenManProcess 



4.3.3.1 



Definition 



This object class is a support object class. Sub-classes of this IOC describe the automated management 
process for an NE. They allow the IRPManager to be informed about the current progress of the process and 
where stop points are set. No intervention of the IRPManager is foreseen except resume after a stop point 
was reached or termination of the self-configuration. 

When the automated management process for an NE starts, an instance of the sub-class of genManProcess 
is created automatically. 

The steps in the stepinf oList shall conform to the content of the relevant sub-class of genManProf ile 

instance. 

Example: 

If the stepsAndOf feredStopPointList of a sub-class instance of genManProf ile indicates 

stopPointCanBeSetBef oreThisStep for step X, then the entry for step X in the stepinf oList of the 

sub-class instance of genManProcess can only have the value stopPointisNotSet . 

When there is no relevant genManProf ile at creation time of genManProcess, then the IRP Agent creates 
the genManProcess based on the relevant genManCapability. In this case preferably no stop point shall 
be set in the self configuration process. 

When the last step of the self configuration process is completed successfully, the genManProcess instance 
is deleted automatically. 

When self configuration process is terminated by the IRPManager, the genManProcess instance is deleted 
automatically. 



4.3.3.2 



Attributes 



Attribute name 


Support Qualifier 


Read Qualifier 


Write Qualifier 


id 


M 


M 


- 


nE I den t i f i c a t i on 


M 


M 


- 


prof ileld 


M 


M 


- 


stepInfoList 


M 


M 


- 



4.3.3.3 Notifications 

None. 
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4.3.4 SwMCapability 

4.3.4.1 Definition 

This object class is a sub-class of genManCapability and represents the IRPAgent"s capability in 
support of SWM. 

It is created by the IRP Agent and cannot be modified by the IRPManager. 

A SwMManagementCapability object is valid for a certain NE type or a set of NE types with a 
certain SW version or set of versions. For an NE there shall be no ambiguity which 
SwMManagementCapability object is valid for the NE. 
Multiple SwMManagementCapability objects may be instantiated in the IRP Agent. 

The object identifies 

a) the sequence of the self-configuration steps 
and for each step 

a.l) the possibility, whether before the step a stop point can be selected, such that the self- 
configuration step is suspended and waits for a request by the IRPManager to resume. 

b) the final administrativestate of the NE after successful self-configuration. 

Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ SWM FUN 5 




3GPP TS 32.531 [6] 


REQ ASWM FUN 1 





4.3.4.2 Attributes 

All attributes inherited from IOC GenManCapability . 
Additional attributes: 



Attribute name 


Support Qualifier 


Read Qualifier 


Write Qualifier 


swVersionToBelnstalledOf f erList 


CM*) 


M 


- 



*) Condition: objectClass_is_swMCapability 



4.3.4.3 



Attribute constraints 



Name 


Definition 


obj ectClass_is_swMCapability 


objectClass is equal to swMCapabilities 



4.3.4.4 



Notifications 



Name 


Qualifier 


Notes 


not ifyNewSwAva liability 
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4.3.5 SwMProfile 



4.3.5.1 



Definition 



This object class is a sub-class of genManProf ile. It allows the IRPManager to select from the stop points 
offered in the swMCapabilites object those which should be used to stop the SW management process for 
NEs, which fit to the nEInf ormation and swVersionToBelnstalled, and which of the 
of f eredFinalAdministrativeStateInf ormation is selected. 

For an NE starting its SWM process there shall be no ambiguity which swMManagementProf ile is valid 
for the NE. Therefore the nEinf ormation of different swMProf ile instances shall not intersect. Example 
for a not allowed intersection: profile 1 has nEinf ormation= (neType=eNB), profile 2 has 
nEInf ormation= ( (neType=eNB) and (Id=l)) ). 

Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 1 




3GPP TS 32.531 [6] 


REQ ASWM FUN 2 




3GPP TS 32.531 [6] 


REQ ASWM FUN 3 




3GPP TS 32.531 [6] 


REQ ASWM FUN 4 





4.3.5.2 Attributes 

All attributes inherited from IOC GenManProf ile . 
Additional attributes: 



Attribute name 


Support Qualifier 


Read Qualifier 


Write Qualifier 


SwVersionToBelnstalled 


CM 


M 


- 



Condition: obj ectClass_is_swMProf ile 

4.3.5.3 Attribute constraints 



Name 


Definition 


obj ectClass_is_swMProf ile 


objectClass is equal to swMProf ile 



4.3.5.4 



Notifications 



Name 


Qualifier 


Notes 


notify S wMProfileCreation 


M 




notify S wMProfileChange 


CM 


Condition: Present if operation changeSwMProf ile is supported. 


notify S wMProfileDeletion 


M 
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4.3.6 SwMProcess 



4.3.6.1 



Definition 



This object class is a sub-class of genManProcess . It describes the SW management process for an NE. It 
allows the IRPManager to be informed about the current progress of the SWM process and where stop points 
are set. No intervention of the IRPManager is foreseen except to provide indication to resume after a stop 
point was reached or to abort the self-configuration. 

When the automated management process for an NE starts, an instance of the swMProcess is created 
automatically. 

The id of the swMProcess shall be identical to the identifier of the NE and identify the swMProcess 
instance uniquely. 

The steps in the stepinf oList shall conform to the content of the relevant swMProf ile instance. 
Example: 

If the stepsAndOf feredStopPointList of swMProf ile indicates 

stopPointCanBeSetBef oreThisStep for step X, then the entry for step X in the stepinf oList of 

swMProcess can only have the value stopPointisNotSet . 

When there is no relevant swMProf ile at creation time of swMProcess, then the IRP Agent creates the 
swMProcess based on the relevant swMCapability. In this case preferably no stop point shall be set in the 
self configuration process. 

When the last step of the self configuration process is completed successfully, the swMProcess instance is 
deleted automatically. 

When self configuration process is terminated by the IRPManager, the swMProcess instance is deleted 
automatically. 

Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 2 




3GPP TS 32.531 [6] 


REQ ASWM FUN 3 




3GPP TS 32.531 [6] 


REQ ASWM FUN 4 




3GPP TS 32.531 [6] 


REQ ASWM FUN 5 




3GPP TS 32.531 [6] 


REQ ASWM FUN 6 





4.3.6.2 Attributes 

All attributes inherited from IOC GenManProcess . 
Additional attributes: None. 



4.3.6.3 



Notifications 



, Name 


Qualifier 


Notes 


notify S wMProces sCreation 


M 




notifySwMProcessStage 


M 




notify S wMProces sDeletion 


M 
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4.3.7 SwMiRP 

4.3.7.1 Definition 

This information object represents a Software Management IRP. It inherits from IOC managedGenericIRP. 

4.3.7.2 Attributes 

All attributes inherited from IOC managedGenericIRP . 
Additional attributes: None. 

4.3.7.3 Notifications 

All notifications inherited from IOC managedGenericIRP . 
Additional notifications: None. 

4.4 Information relationship definitions 

4.4.1 relation-swMIRP-swMCapability (M) 

4.4.1.1 Definition 

This represents the relationship between SwMIRP and SwMCapability. 

4.4.1.2 Roles 



Name 


Definition 


theSwmIRP 


It represents the SwmIRP . 


theSwMCapability 


It represents the SwMCapability 



4.4.1.3 Constraints 

There is no constraint for this relationship. 
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4.4.2 relation-SwmlRP-swMProfile (M) 

4.4.2.1 Definition 

This represents the relationship between SwmIRP and SwMProf ile. 

4.4.2.2 Roles 



Name 


Definition 


theSwmIRP 


It represents the SwmIRP . 


theSwMProf ile 


It represents the SwMProf ile . 



4.4.2.3 Constraints 

There is no constraint for this relationship. 

4.4.3 relation-swM I RP-swM Process (M) 
4.4.3.1 Definition 

This represents the relationship between SwmIRP and SwMProcess. 



4.4.3.2 



Roles 



Name 


Definition 


theSwMIRP 


It represents the SwMIRP . 


theSwMProcess 


It represents the SwMProcess . 



4.4.3.3 Constraints 

There is no constraint for this relationship. 
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4.4.4 relation-swMCapabilites-swMProfile (M) 

4.4.4.1 Definition 

This represents the relationship between swMCapability and swMProf ile. 

4.4.4.2 Roles 



Name 


Definition 


theSwMCapability 


It represents the swMCapability . 


theSwMProf ile 


It represents the swMProf ile . 



4.4.4.3 



Constraints 



A relation can only exist between a SwMProf ile and a SwMCapability when 

a) all steps which are entries in the stepsAndSelectedStopPointList of SwMProf ile have 

stopPointCanBeSetBeforeThisStep = Yes in the stepsAndOf f eredStopPointList of the 

SwMCapability.b) nEInformation of SwMProf ile is a subset of nEInf ormation of 

SwMCapability. 

4.4.5 relation swMProfile-swMProcess (M) 

4.4.5.1 Definition 

This represents the relationship between SwMProf ile and SwMProcess. 

4.4.5.2 Roles 



Name 


Definition | 


theSwMProfile 


It represents the theSwMProfile . 


theSwMProcess 


It represents the SwMProcess . 



4.4.5.3 



Constraints 



A SwMProcess shall perform all self-configuration steps according to stepsAndOff eredStopPointList of 
SwMProf ile. 

A relation can only exist between a SwMProcess and a SwMProf ile when 

nEldentif ication of SwMProcess falls into nEInformation of SwMProf ile. 
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4.5 



Information attribute definitions 



4.5.1 Definition and legal values 



Attribute Name 


Definition 


Legal Values 


id 


It identifies uniquely an instance of its object class. 




nEIdentif ication 


This attribute identifies the NE for which the self management activity is done. 




nEInformation 


This attribute defines the neType or NE instance/s - with optional software identification 
information - , for which this capability/profile instance is valid. 


'NE instance/s' only applies for instance/s already known to the 
IRPManager, e.g. in case of re-configuration or SW update. 


startStepName 


nameOfStep, this attribute defines the start step for resume operation. 


The legal value of startStepName could be one of the step which defined 

in StepsAndOf f eredStopPointList 


swVersionToBe Installed 


This attribute describes which SW identification information shall be used at the end of self 
management in NEs for which this swMCapability/swMProf ile applies. 




stepsAndOf f eredStopPoint 
List 


Each entry in the list contains for each step the following information: 

• nameOfStep: 

This list shall be exhaustive; if a certain step is not visible or not supported in the SWM 
process, then it shall not be shown (hsted) in the stepsAndOf f eredStopPointList. 

• sequenceNumberlnProcess 

• stopPointCanBeSetBeforeThisStep 


nameOfStep : 

swDownload, 

swinstallation, 

swActivation 

More values for nameOfStep may be used by other IRPs. 

All steps may be offered as stop points. 

sequenceNumberlnProcess : 
Positive Integer 

stopPointCanBeSetBeforeThisStep: Yes, No 


stepsAndSelectedStopPoin 
tList 


Each entry in the list contains for each step the following information: 

• nameOfStep: 

• sequenceNumberlnProcess 

• stopPointSetlndication 


nameOfSwMStep, 

sequenceNumberlnProcess : 

see StepsAndOf f eredStopPointList 

StopPointSetlndication : 
stopPointlsSetBeforeThisStep, stopPointlsNotSet 
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stepInfoList 


This list attribute contains information about all steps and how far they have progressed. Each 
entry in the list contains: 

• nameOfStep 

• sequenceNumberlnProcess 

• stopPointSetlndication 

• stepProgress 


nameOfSwMStep, 

sequenceNumberlnProcess : 

see stepsAndOf f eredStopPointList 

StopPointSetlndication : 

see stepsAndSelectedStopPointList 

StepProgress : 

notYetStarted, 

running, 

completed, 

awa i t ingRe sume , 

failure, 

terminated 


swMprocessList 


This attribute contains information about the instances of swMProcess . Each entry in the list 
contains (SET OF): 

• id 

• nEIdentif ication 

• StepInfoList 


See individual definitions of the list entry content. 


of feredFinalAdmini strati 
veState Information 


It describes which selection is offered regarding the administrativeState of the NE after 
successful automated management: If it may have the value locked or unlocked or if the value of 
the administrativeState may be determined by the configuration data which is uploaded in the 
course of the automated management. 


One or more of the following values: 

locked, 

unlocked, 

determinedByConf igurationData 

The value unlocked should always be present. 


select edFinalAdmini St rat 
iveState 


Determines which of the offers made regarding the administrativeState of the NE after successful 
self- configuration is taken. 


One of the following values: 

locked, 

unlocked, 

determinedByConf igurationData 

Default value is value unlocked. 


swVersionToBelnstalledOf 
ferList 


This list describes for which SW version/s the capability object is valid. 


Minimum size of list: 1 entry 


versionNumber 


This number is the version number of a profile. Its value is 1 when a profile is created. It is 
incremented by 1 each time a profile is successfully changed. 


Integer 


prof ileld 


This parameter records the identification of the profile used by the process. It consists of two 
data: 

• id (of the profile) 

• versionNumber 


See versionNumber 


matchingNEInformation 


This parameter records the information of the NE which was matching with the nEInformation of 
the profile when determining which profile is to be used for the process. 


See nEInformation 
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result 


This parameter records the result of an operation. 


success, 

failure, 

stepNameNotMatch: The current process step doesn"t match the 

startStepName in the operation. 

nEInf ormationlntersection : There shall be no ambiguity 

which swMManagementProfile is valid for the NE. Therefore the 

nEInf ormation of different swMProf ile instances shall not 

intersect. Example for a not allowed intersection: profile 1 has 

nEInformation= (neType=eNB), profile 2 has 

nEInformation= ( (neType=eNB) and (ld=1)). 



4.5.2 Constraints 



Name 


Definition 


FFS 
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5 IRP descriptions: Interface Definitions 

5.1 Class diagram representing interfaces 

The diagram reflects the definitions in the text of the following clauses.. In case of conflict text 
takes precedence. 



«Notification» 
AlarmlRPNotifications_1 



notifyNewAlarmO 
notifyAckStateChangedO 
notifyClearedAlarmO 
notifyAlarmListRebuiltO 



«Notification» 
AlarmlRPNotification_2 



«lnterface» 
SwMOperations_1 

createSwMProfileO 

deleteSwMProfileO 

listSwMCapabilities() 

listSwMProcesses() 

listSwMProfiles() 

resumeSwMProcess() 

terminateSwMProcessO 



«lnterface» y\^ 

SwMOperations_2 

changeSwMProfileO 




notifyChangedAlarmO 

/J 
«may.use» 



«lnformationObjectClass» 
NotificationIRP 

(from TS 32.302) 



«lnformationObjectClass» 
Alarm IRP 

(from TS 32.111-2) 

«agent-inteynal-usage» 



^ A 
«agent-internal-usa^» 



«Notification» 
SwMNotifications_1 



«agent-internal-usage>: 



not! 
not! 
not! 
not! 
y not! 
not! 



fyNewSwMCapabilitiesAvailabilityO 

fySwMProcessCreationO 

fySwM P rocessDel etio n 

fySwM P rocessStageO 

fySwMProfileCreationO 

fySwMProfileDeletionO 



«lnformationObjectClass» 
SwManagement IRP 



«Notification» 
SwMNotifications_2 



notifySwMProfileChangeO 



5.2 



Generic rules 



- Rule 1: each operation with at least one input parameter supports a pre-condition valid_input_parameter which 
indicates that all input parameters shall be valid with regards to their information type. Additionally, each such 
operation supports an exception operation_failed_invalid_input_parameter which is raised when pre-condition 
valid_input_parameter is false. The exception has the same entry and exit state. 

- Rule 2: each operation with at least one optional input parameter supports a set of pre-conditions 
supported_optional_input_parameter_xxx where "xxx" is the name of the optional input parameter and the pre- 
condition indicates that the operation supports the named optional input parameter. Additionally, each such 
operation supports an exception operation_failed_unsupported_optional_input_parameter_xxx which is raised 
when (a) the pre-condition supported_optional_input_parameter_xxx is false and (b) the named optional input 
parameter is carrying information. The exception has the same entry and exit state. 

- Rule 3: each operation shall support a generic exception operation_failed_internal_problem which is raised 
when an internal problem occurs and that the operation cannot be completed. The exception has the same entry 
and exit state. 

NOTE: These rules are mapped at the solution set level. Pre-conditions and exceptions, generated by these rules, 
need not appear explicitly in the present document. 
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5.3 SwMIRPOperations_1 Interface (M) 

5.3.1 Operation listSwMCapabilities (M) 



5.3.1.1 



Definition 



This operation allows the IRPManager to determine on the Itf-N interface which steps in the SW 
management are performed in NEs of a certain type, what is done by the NE in case a step does not perform 
normally and before which steps a stop point can be set, such that the software download halts and waits for 
a continuation request by the IRPManager. 

Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 1 





5.3.1.2 



Input parameters 



Parameter 
Name 


Qualifier 


Information type 


Comment 


nEInformation 


M 


swM . nEInformation 


If this input parameter contains no information, all (offered) 
SwMCapability instances are to be listed in the output. 



5.3.1.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


capabilityList 


M 


swM . capabilityList 


Each entry in the list contains: 

• Id of SwMCapability 

• nEInformation of SwMCapability 

• swVersionToBelnstalledOf f erList of 
SwMCapability 

• stepsAndOf f eredStopPointList of SwMCapability 

• of feredFinalAdmini St rati vest ate Information 
of SwMCapability 


result 


M 


swM. result 


result = success and empty swMCapabilityList mean: No 
instance found. 



5.3.1.4 



Post-condition 



Assertion Name 


Definition 


dataDelivered 


The requested data is delivered. 



5.3.1.5 Exceptions 

5.3.1 .5.1 operationjailed 



Exception Name 


Definition 


operation failed 


Condition: Pre-condition is false or post-condition is false. 
Returned Information: The output parameter result. 
Exit state: Entry state. 
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5.3.2 Operation listSwMProf iles (M) 



5.3.2.1 



Definition 



This operation allows the IRPManager to find out which instances of SwMProf ile are valid NEs of a certain 
type. 

Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 1 




3GPP TS 32.531 [6] 


REQ ASWM FUN 2 





5.3.2.2 



Input parameters 



Parameter 
Name 


Qualifier 


Information type 


^^^^^^^^^^ Comment ^^^^ 






nEInformation 


M 


swM . nEInformation 


If this input parameter contains no information, all profile instances are to 
be listed in the output. 



5.3.2.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


swMprof ileList 


M 


swM . swMprof ileList 


Each entry in the list contains: 

• Id of profile 

• versionNumber of swMprofile 

• nEInformation of profile 

• stepsAndSelectedStopPointList of profile 

• selectedFinalAdministrativeState of 
profile 

• conditionally*) swVersionToBe Installed of 
swMprofile 


result 


M 


swM. result 





*) condition see §4.3.5.3 



5.3.3 Operation createSwMProf ile (M) 



5.3.3.1 



Definition 



This operation allows the IRPManager to establish an instance of SwMProf ile to be valid for NEs of a 
certain type. 

Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 2 
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5.3.3.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


id 





swM. id 


Identifier of 
swIVIprofile 


nEInformation 


M 


swM . nEInformation 


See 4.5 


swVersionToBe Installed 


M 


swM . swVersionToBelnstalled 


See 4.5 


stepsAndSelectedStopPointList 


M 


swM . StepsAndSelectedStopPointList 


See 4.5 


select edFinalAdminist rat iveS tat e 


M 


swM . selectedFinalAdministrativeState 


See 4.5 



5.3.3.3 



Output parameters 



Parameter 
Name 


Qualifier 


Matching 
Information 


Comment 


id 


0*) 


swM. id 


*) See below 


result 


M 


swM. result 


If result = success , then parameter id contains the id of the created 
swMProf ile . 

If result = failure , then parameter id is absent. 

If result = nEInformationlntersection, then parameter id contains 
the id of a swMProfile whose nEInformation would intersect with the 
proposed nEInformation for the new swMProfile, which was not created 
in this case. 



5.3.4 Operation deleteSwMProf ile (M) 
5.3.4.1 Definition 

This operation allows the IRPManager to delete an instance of swMProfile. 
Inforaiation on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 2 





5.3.4.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


id 


M 


swM. id 


Identifier of swMprofile 



5.3.4.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


result 


M 


swM. result 
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5.3.5 Operation listSwMProcesses (M) 
5.3.5.1 Definition 

This operation allows the IRPManager to find out the status of one or several swMProcess instances 
Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 4 





5.3.5.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


nEIdentif ication 





swM . nEIdentif ication 


It describes for which NE the swMprocess is to be listed. 

If this parameter is not present, all swMprocess instances are to be 
listed in the output. 



5.3.5.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


swMprocessList 


M 


swM . swMprocessList 


See 4.5 


result 


M 


swM. result 


result=success and empty swMProcessList mean: No 
instance found 



5.3.6 Operation resumeSwMProcess (M) 



5.3.6.1 



Definition 



This operation allows the IRPManager to resume a SW management process which currently has stopped at 
a stop point step. 

Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 3 





5.3.6.2 



Input parameters 



Parameter 
Name 


Qualifier 


Information type 


Comment 


id 


M 


swM. id 


Identifier of swMprocess 


startStepName 


M 


swM.NameOfStep 


The start step for the resume operation. 

If the current process step is equal to the startStepName value, the process 

will start from startStepName . 

If the current process step does not match the startStepName value, then it 

will be indicated in the result of the operation. Not matching 

StartStepName value can either be the case that the process has already 

started from the specified step (i.e. request is too late) or that the process has not 

yet reached the specified step (i.e request is too early). 
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5.3.6.3 



Output parameters 



Parameter Name Qualifier Matching Information Comment 


result 


M 


swM. result 





5.3.7 Operation swFallback (M) 

5.3.7.1 Definition 

This operation enables the IRPManager to initiate a SW fallback. 

Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ SWM FUN 6 





5.3.7.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


filter 


M 


swM. filter 


To describe properties of the NEs to be selected. 



5.3.7.3 



Output parameters 



Parameter 
Name 


Qualifier 


Matching 
Information 


Comment 


nEList 


M 


swM. nEList 


Each entry in the list contains: 

nEIdentif ication 

swFallbackStatus (values : f allbackSuccessful , 

fallbackUnsuccessful) 


result 


M 


swM. result 


• Success, 

• Partly successful - swFallbackStatus is 
fallbackUnsuccessful for at least one NE 

and fallbacksuccessful for at least one Other NE 

• Failure 

Empty NEList and Result=Success means: No NEs fulfilling filter 
were found. 
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5.3.8 Operation terminateSwMProcess (M) 
5.3.8.1 Definition 

This operation allows the IRPManager to terminate a SW management process which is currently ongoing. 
Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 6 





5.3.8.2 Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


id 


M 


swM. id 


Identifier of swMprocess . 



5.3.8.3 Output parameters 



Parameter Name Qualifier Matching Information Comment 


result 


M 


swM. result 
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5.4 SwMIRPOperations_2 Interface (O) 

5.4.1 Operation changeSwMProf ile (O) 
5.4.1.1 Definition 

This operation allows the IRPManager to change an instance of SwMProfile. 

A change in a profile which was already used at the start of an swMProcess does not affect that swMProcess (which is 
run to its completion according to the former version of the profile. 

Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 2 





5.4.1.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


id 


M 


swM. id 


Identifier of 
swMprofile 


nEInformation 


M 


swM . nEInformation 


See 4.5 


swVersionToBe Installed 


CM*) 


swM . swVersionToBelnstalled 


See 4.5 


stepsAndSelectedStopPointList 


M 


swM . StepsAndSelectedStopPointList 


See 4.5 


select edFinalAdminist rat iveS tat e 


M 


swM . selectedFinalAdministrativeState 


See 4.5 



*) See §4.3.5.2 



5.4.1.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


result 


M 


swM. result 


If result = success or failure , then 
parameter id may be absent or contain the id 
of the changed swMprofile . 
If result = 

nEInf ormationlntersection, then 
parameter conf lictingProf ileld 
contains the id of a swMprofile 'A' whose 
nEInformation would intersect with the 
proposed nEInformation for the swMprofile 
'B' = input parameter id. swMprofile 'B' will 
not be changed in this case. 


versionNumber 


M 


swM. versionNumber 


See 4.5. This parameter has value when 
result <> success. 


conf lictingProf ileld 


C*) 


swM. conf lictingProf ileld 


See definition of result above. 



*) Condition: result_is_nEInf ormationlntersection 



5.4.1.4 



Constraints 



Name 


Definition 


result is nEInf ormationlntersection 


result is equal to nEInf ormationlntersection 
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5.5 SwMIRPNotifications_1 Interface (M) 
5.5.1 Notification notifySwMProfileCreation (M) 
5.5.1.1 Definition 

This notification conveys information about the creation of an instance of IOC swMProfile. 



5.5.1.2 



Input parameters 



Parameter Name 


Qualifiers 


Matching Information 


Comment 


id 


M,Y 


swM. id 


Identifier of 
swMprofile 


versionNumber 


M, Y 


swM . versionNumber 


See 4.5 


nEInformation 


M,Y 


swM . nEInformation 


See 4.5 


swVersionToBe Installed 


CM,Y*) 


swM . swVersionToBelnstalled 


See 4.5 


stepsAndSelectedStopPointList 


M,N 


swM . StepsAndSelectedStopPointList 


See 4.5 


select edFinalAdminist rat iveS tat e 


M,N 


swM . selectedFinalAdministrativeState 


See 4.5 



*) See §4.3.5.2 

5.5.2 Notification notifySwMProfileDeletion (M) 
5.5.2.1 Definition 

This notification conveys information about the deletion of an instance of IOC swMProfile. 
Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 2 





5.5.2.2 



Input parameters 



Parameter Name 


Qualifiers 


Matching Information 


Comment 


id 


M,Y 


swM. id 


Identifier of swMprofile 
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5.5.3 Notification notifySwMProcessCreation (M) 
5.5.3.1 Definition 

This notification conveys information about the creation of an instance of IOC swMProcess. 
Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 2 





5.5.3.2 



Input parameters 



Parameter Name 


Qualifiers 


Matching Information 


Comment 


id 


M,Y 


swM. id 


Identifier of swMprocess 


nEIdentif ication 


M,Y 


swM. nEIdentif ication 


see 4.5 


prof ileld 


M,N 


swM. prof ileld 


see 4.5 


matchingNEInformation 


M,N 


swM. matchingNEInformation 


see 4.5 


stepInfoList 


M,N 


swM . StepInfoList 


see 4.5 



5.5.4 Notification notifySwMProcessStage (M) 



5.5.4.1 



Definition 



This notification conveys information about the stage of an instance of IOC swMProcess that has been 
completed or at which that process has been stopped (based on pre-set stop points). 

Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 5 





5.5.4.2 



Input parameters 



Parameter Name 


Qualifiers 


Matching Information 


Comment 


id 


M,Y 


swM. id 


Identifier of swMprocess 


StepInfoList 


M,N 


swM . StepInfoList 


see 4 . 5 
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5.5.5 Notification notifySwMProcessDeletion (M) 
5.5.5.1 Definition 

This notification conveys information about the deletion of an instance of IOC swMProcess 

IRP Agent shall also send out this notification in case of a process termination caused by an exception, for example IRP 
Agent terminates the process because it had to wait too long after a suspend operation. 

Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 2 





5.5.5.2 



Input parameters 



Parameter Name 


Qualifiers 


Matching Information 


Comment 


id 


M,Y 


swM. id 


Identifier of swMprocess 


triggerForDeletion 


M, Y 


swM . triggerForDeletion 


This parameter describes what triggered the 
deletion of the swMprocess instance: 
triggerForDeletion : 

irpAgentTermination, 

irpManagerTermination, 

automatedSWMSuccesfullyConcluded 


additional Information 


0, N 


swM . additionalinf ormation 





5.5.6 Notification not ifyNewSwAvai lability (IVI) 
5.5.6.1 Definition 

This notification conveys information about the availability of new SW. 
Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ SWM FUN 3 





5.5.6.2 



Input parameters 



Parameter Name 


Qualifiers 


Matching Information 


Comment 


nEandSWversion 


M,Y 


swM. NEandSWversion 


Informs about new available SW, SW version and NE / NE 
version (types) for which it is valid 



ETSI 



3GPP TS 32.532 version 8.1.0 Release 8 



33 



ETSI TS 132 532 V8.1 .0 (2009-07) 



5.6 SwMIRPNotifications_2 Interface (O) 

5.6.1 Notification notifySwMProf ileChange (C/0) 
5.6.1.1 Definition 

This notification conveys information about a change of an instance of IOC swMProf iie. 
Information on Requirements Traceability: 



Referenced TS 


Requirement label 


Comment 


3GPP TS 32.531 [6] 


REQ ASWM FUN 2 





5.6.1.2 



Input parameters 



Parameter Name 


Qualifiers 


Matching Information 


Comment 


id 


M,Y 


swM. id 


Identifier of 
swMprofile 


versionNumber 


M,Y 


swM . versionNumber 


See 4.5 


nEInformation 


M,Y 


swM . nEInformation 


See 4.5 


swVersionToBe Installed 


CM,N *) 


swM . swVersionToBelnstalled 


See 4.5 


stepsAndSelectedStopPointList 


M,N 


swM . StepsAndSelectedStopPointList 


See 4.5 


select edFinalAdminist rat iveS tat e 


M 


swM . selectedFinalAdministrativeState 


See 4.5 



*) See §4.3.5.2 
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Annex A (informative): Change history 



Change history 


Date 


TSG# 


TSG Doc. 


CR 


Rev 


Subject/Comment 


Old 


New 


2008-12 


SP-42 


SP-080717 






Submitted to SA#42 for information and approval 


1.0.0 


8.0.0 


2009-06 


SP-44 


SP-090408 


001 


-- 


Correction of naming errors 


8.0.0 


8.1.0 


2009-06 


SP-44 


SP-090408 


002 


-- 


Add missing start step parameter for resume operation 


8.0.0 


8.1.0 
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History 



Document history 


V8.0.0 


February 2009 


Publication 


V8.1.0 


July 2009 


Publication 
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